Project Management & Quarto

STAT 551

R Projects!

Artwork by @allison_horst
  • Self contained

  • Flag where R should look for files

  • Allow for us to easily use here() to find files

  • Should be how you work in RStudio every time

Why use here() to read in your data?

Artwork by @allison_horst
  • Never set a relative / full path or change your working directory!!!
setwd("/Users/atheobol/Documents/Teaching/Stat 551/")
  • Working in R? Rendering a document? here() uses the same path to load in data!

Your turn!

  1. Open RStudio
  2. Choose “File” and “New Project”

If you already made a STAT 551 folder

  1. Choose “Existing Directory”.
  2. Browse to where your STAT 551 folder lives
  3. Click “Create Project”

If you have not already made a STAT 551 folder

  1. Choose “New Directory”.
  2. Type what name you want your folder to have.
  3. Browse to where you want your folder to live (e.g., Documents).
  4. Click “Create Project”

Quarto

Why use Quarto?

Quarto unifies and extends
the R Markdown ecosystem

Quarto unifies and extends
the R Markdown ecosystem


unifies for people who love R Markdown


extends for people who don’t know R Markdown

The R Markdown ecosystem

Hex logos for various packages from the R Markdown ecosystem.

Quarto: Next generation R Markdown

Quarto logo.

Quarto highlights

One quadrant of the Quarto logo. Consistent implementation of attractive and handy features across outputs: tabsets, code-folding, syntax highlighting, etc.

Two quadrants of the Quarto logo. More accessible defaults as well as better support for accessibility

Three quadrants of the Quarto logo. Guardrails, particularly helpful for new learners: YAML completion, informative syntax errors, etc.

Four quadrants of the Quarto logo. Support for other languages like Python, Julia, Observable, and more via Jupyter engine for executable code chunks.

Quarto CLI orchestrates each step of rendering

A schematic representing rendering of Quarto documents from .qmd, to knitr or jupyter, to plain text markdown, then converted by pandoc into any number of output types including html, PDF, or Word document.

Quarto makes moving between formats straightforward

Document

lesson-1.qmd

title: "Lesson 1"
format: html

Presentation

lesson-1.qmd

title: "Lesson 1"
format: revealjs

Website

_quarto.yml

project:
  type: website

website: 
  navbar: 
    left:
      - lesson-1.qmd

Welcome to Quarto!

Components of a Quarto

Formatting the text in your document

Markdown is a markup language. This means special symbols and formatting to pretty documents.

*text* – makes italics

**text** – makes bold text

# – makes headers

![ ]( ) – includes images or HTML links

< > – embeds URLs

R code options

The Hash Pipe

#|

Rendering your document

Let’s try it!